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NOTIFICATIONS WEB SERVICE 

TECHNICAL FIELD 

[0001] Embodiments of the present invention relate to the field of software 
notifications. In particular, embodiments of this invention relate to implementing an 
extensible messaging framework in a web sen/ice for managing notifications. 

BACKGROUND OF THE INVENTION 

[0002] Up-to-date information in a wide variety of areas is very important to many 
people. These people often desire to be alerted to time-sensitive events and 
information. Content providers generate content for notifications, which are then 
delivered to one or more user electronically (e.g., via electronic mail). For example, a 
news organization may provide notification content relating stock prices, breaking news, 
weather conditions, traffic conditions, etc. A user's expressed interest to receive 
electronic notifications for a particular class of content is generally called a notification 
subscription. Such subscriptions often are made between the end user and the content 
provider that sends the notifications. Event-driven notifications of this type are often 
referred to as alerts. 

[0003] A notification generally consists of two parts: (i) the routing/address 
information; and (ii) the message payload. However, different alert notification systems 
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can have different protocols particular to the individual system. Information or content 
providers must then tailor the notifications to the particular systems, which complicates 
the delivery and management of notifications. 

[0004] Accordingly, a generalized notification mechanism that allows for greater 
interoperability across different systems is desired to address one or more of these and 

other disadvantages. 

SUMMARY OF THE INVENTION 

[0005] Embodiments of the invention overcome one or more deficiencies in the 
prior art by providing a programming model for managing notification-based 
applications. In one embodiment, the invention implements protocols based on an 
extensible messaging framework such as Simple Object Access Protocol (SOAP). As 
such, the protocols allow for greater interoperability across disparate systems. The 
design of these protocols has many provisions for extensibility, which allows notification- 
based applications in many domains to employ the protocols as the programming 
model. 

[0006] A web-based notifications service embodying aspects of the invention 
serves as an intermediary between content providers and end users. In this instance, 
the protocols are geared towards synchronizing the subscriptions information of the 
intermediary along with the publisher or content provider. Embodiments of the invention 
facilitate and maintain a topic web service to gather minimal information necessary to 
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enable intelligent routing rules rather than requiring that information needed for 
advanced routing is present in each notification packet sent by the content provider. 
[0007] The invention relieves content providers of the need to tailor the 
notifications to the particular systems. In one embodiment, the invention provides a 
generalized notification mechanism (e.g., encompassed by a SOAP-based notification 
protocol) that allows for greater interoperability across different systems. Content 
providers can more easily program their systems to send notifications. 
[0008] Moreover, the features of the present invention described herein are less 
laborious and easier to implement than currently available techniques as well as being 
economically feasible and commercially practical. 

[0009] Briefly described, a method embodying aspects of the invention manages 
notifications in a web-based notifications system. The notifications system is configured 
to provide notifications containing content provided by a content provider to a user via a 
data communication network. The content relates to one or more topics. The method 
includes implementing a web service responsive to requests structured according to an 
extensible messaging framework. The method also includes receiving, at the web 
service, a request from a content provider. The request specifies a selected notification 
management function and is structured according to the messaging framework. The 
method also includes extracting request information, including at least a content 
provider identifier and a topic identifier, from the request and executing the selected 
notification management function based on the extracted request information. 
[0010] In another embodiment, a method for managing notifications in a web- 
based notifications system includes implementing a web service responsive to requests 
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structured according to an extensible messaging framework. The method also includes 
receiving, at the web service, a request structured according to the messaging 
framework from a content provider and extracting request information from the request. 
The request information includes at least a content provider identifier, a topic identifier, 
and a user identifier. The method further includes querying a user profile store for 
profile information corresponding to the user identifier, determining routing information 
for a notification based on the profile information, and creating a subscription 
corresponding to the topic identifier, the user identifier, and the routing path for the 
notification. 

[0011] Yet another embodiment of the invention relates to a web-based system 
for processing notifications. The notifications contain content relating to one or more 
topics provided by one or more content providers. The system includes a computing 
device to implement a web service responsive to requests structured according to an 
extensible messaging framework. The computing device is coupled to a data 
communication network and configured to receive a request from a content provider via 
the data communication network. The request from the content provider specifies a 
selected notification management function. The request is structured according to the 
messaging framework. The system also includes a computer-readable medium that 
stores computer-executable instructions to be executed on the computing device to 
extract request information from the request. The information includes a content 
provider identifier and a topic identifier associated with the request and to perform the 
selected notification management function based on the extracted request information. 
The system further includes a memory associated with the computing device to store 
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the extracted request information in connection with the selected notification 
management function. 

[0012] Another web-based system for processing notifications embodying 
aspects of the invention includes a computing device to implement a web service 
responsive to requests structured according to an extensible messaging framework. 
The computing device is coupled to a data communication network and configured to 
receive a request from a content provider via the data communication network. The 
system also includes a user profile store that is associated with the computing device to 
store information representative of a plurality of users and a computer-readable medium 
that stores computer-executable instructions to be executed on the computing device to 
extract request information from the request. The request information includes a 
content provider identifier, a topic identifier, and a user identifier associated with the 
request, to query the user profile store for profile information corresponding to the user 
identifier, to determine routing information for a notification based on the profile 
information, and to create a subscription corresponding to the topic identifier, the user 
identifier, and the routing path for the notification. 

[0013] In yet another embodiment, a web service that manages notifications in a 
web-based notifications system includes a computing device to implement the web 
service. The computing device is coupled to the data communication network and 
configured to receive requests structured according to an extensible messaging 
framework from one or more content providers via the data communication network. 
The service also includes a computer-readable medium that stores computer- 
executable instructions to be executed on the computing device to provide the 
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extensible messaging framework to the content providers to create requests. The 
requests when structured according to the messaging framework each specify a 
selected notification management function and contain request information. The 
request information for each of the requests includes a content provider identifier and a 
topic identifier associated therewith. The computer-readable medium further stores 
computer-executable instructions to be executed on the computing device to extract the 
request information for each of the requests and to perform the selected notification 
management function based on the extracted request information. 
[0014] Computer-readable media having computer-executable instructions for 
performing methods of notifications management embody further aspects of the 
invention. 

[0015] Alternatively, the invention may comprise various other methods and 
apparatuses. 

[0016] Other features will be in part apparent and in part pointed out hereinafter. 



BRIEF DESCRIPTION OF THE DRAWINGS 



[0017] FIG. 1 is a block diagram illustrating one example of a suitable alerts 
service environment in which the invention may be implemented. 
[0018] FIG. 2 is an exemplary flow diagram illustrating operation according to one 
embodiment of the invention. 

[0019] FIG. 3 is an exemplary block diagram illustrating a detailed view of the 
alerts service illustrated in FIG. 1. 
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[0020] FIGS. 4A to 4C are each portions of an exemplary flow diagram illustrating 
operation of a subscription management web service according to one embodiment of 
the invention. 

[0021] FIGS. 5A to 5E are each exemplary flow diagrams illustrating aspects of 
operation of a subscription management web service and topic management web 
service according to embodiments of the invention. 

[0022] FIG. 6 is a block diagram illustrating one example of a suitable computing 
system environment in which the invention may be implemented. 
[0023] Corresponding reference characters indicate corresponding parts 
throughout the drawings. 



DETAILED DESCRIPTION OF THE INVENTION 

[0024] Referring first to FIG. 1 , an exemplary block diagram illustrates one 
example of a suitable alerts service environment in which the invention may be 
implemented. FIG. 1 illustrates the communication flow between a content provider 102 
such as content provider #1 through content provider #N, an alerts service 104, and a 
user device 106 such as user device #1 through user device #M. The content provider 
102, the alerts service 104, and the user device 106 are coupled to a data 
communication network such as described with reference to FIG. 6. The content 
provider 102 sends a notification to the alerts service 104 for delivery to one or more of 
the user devices 106. Alerts service 104 accesses a subscription database 108 storing 
subscription information and user routing preferences 110 to determine which user 
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device(s) 106 should receive the alert. Alerts service 104 then delivers the alert to the 
determined user device 106. In one example, the alerts service environment is referred 
to as a notification pipeline and database (NPD). 

[0025] The alerts service 104 illustrated in FIG. 1 transcends any one particular 
transport medium for delivery of notifications. The invention may use any of a plurality 
of transport mediums such as electronic mail, instant messaging, mobile short- 
message-service messaging, wireless communications, etc. 
[0026] Aspects of the present invention provide a generalized notification 
mechanism for greater interoperability across different systems. In general, a web- 
based notifications system (i.e., alerts service 104) operating in accordance with 
embodiments of the invention sends a message, often referred to as a notification or 
alert, to a subscribing user via his or her specified user device 106. The message 
contains event-driven information from content provider 102 relevant to a topic of 
interest to which the user has signed up. In other words, a subscriber is a user or other 
entity that expresses an interest in a topic and receives notifications related to the topic 
from content provider 102. In one embodiment, the combination of a subscriber and a 
topic constitutes a subscription. Exemplary topics for alerts include news, weather, 
sports, finance, traffic, hobbies, bargains, and so forth. As described above, the 
notifications are usually driven by events such as breaking news, changes in weather or 
traffic conditions, auction outbid notices, etc. 

[0027] The invention includes protocols for notification-based applications, which 
center on generating and sending notifications. In one embodiment, a set of protocols 
for this class of applications is based on Simple Object Access Protocol (SOAP). The 
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protocols provide the basis for a programming model for managing notification-based 
applications and serve as building blocks for a platform for such applications. Inasmuch 
as the protocols are based on SOAP, for example, they allow for greater interoperability 
across disparate systems. The design of these protocols has many provisions for 
extensibility, which allows notification-based applications in many domains to employ 
the messaging framework of the invention as the programming model. 
[0028] Notification-based applications may also be referred to as 
publisher/subscriber applications. In this instance, subscribers create subscriptions for 
the topics of interest to them. When an event occurs, a notification-based application 
matches the topic corresponding to the event with the subscriptions. The notification 
system then sends the appropriate notification to each subscriber for the matches. 
[0029] Referring further to FIG. 1 , alerts service 104 processes notification or 
alert information received via the data communication network from content provider 
102. An interface component 1 12 receives a data packet representing the notification 
and alerts service 104 stores it in a memory area. In one example, the memory area 
includes a plurality of databases (not shown). The notification includes routing 
information and content. One or more computing devices associated with the alerts 
service 104 enable delivery of the stored notification to one or more subscribing users 
based on the routing information. 

[0030] The user device 106 may be a computer such as computer 70 described 
with reference to FIG. 6. Further, user device 106 may execute an alerts application 
(e.g., an instant messaging application) that receives and processes alerts. The alerts 
application executes on user device 106, which may also be, for example, a cellular 
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telephone (e.g., a Smartphone device), a pager, or a handheld computing device (e.g., 
a personal digital assistant or a Pocket PC device). Moreover, user device 106 may 
include any of the above exemplary devices enabled with an information service such 
as a SMART PERSONAL OBJECTS TECHNOLOGY (SPOT) brand of 
telecommunication service and/or devices. The information service comprises a 
computing infrastructure (e.g., a telecommunication service) for sending data and 
information to personal and home devices via computer networks, wireless networks 
and the Internet. User devices 106 that may be enabled with the information sen/ice 
include, but are not limited to, the following devices: clocks, alarm clocks, radios 
incorporating clocks, watches, billfolds, wallets, checkbook and passbook wallets, 
purses, pens, metal key rings, key holders, wireless devices, computer hardware (e.g., 
peripherals, monitors, and displays), electronic calendar devices, and refrigerator 
magnets. Further, magazines, books, and user manuals relating to computers, 
computer programs, personal information devices and wireless communications may 
also incorporate the information service. The information service enables billions of 
devices to communicate with each other. For example, customers select the type of 
information and services they want to receive on the enabled devices via a configuration 
web page. This content is subsequently beamed to and displayed on the device. 
Information available to users on devices using the information service includes 
personal messages, calendar updates, and customized news, weather, financial and 
sports information. 

i 

[0031] In one embodiment, the system shown in FIG, 1 is implemented as a web 
service and functionality associated with alerts service 104 may be distributed among 
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one or more computers. For example, alerts service 104 may include a distributed 
processing system. When content provider 102 posts an alert such as in the form of an 
extensible markup language (XML) document, alerts service 104 parses the alert and 
validates the packet. Alerts service 104 may also asynchronously process the alert by 
queuing it into an NPD queue or other memory area. The NPD queue represents an 
internal queue of work items that are acted upon by any one of the multiple threads in 
the thread pool, but only one thread processes the item at any given time. The alerts 
service 104 then retrieves information regarding, for example, a specific broadcast list 
specified in the alert, such as the number of members or users, and an internal 32-bit 
row identifier from a database such as a broadcast list database (BLDB) (see FIG. 3). 
[0032] Referring next to FIG. 2, an exemplary flow chart illustrates operation of 
alerts service 104. One or more computer-readable media have computer-executable 
instructions for performing the method illustrated in FIG. 2. The invention software or 
other computer-executable instructions implements a web service responsive to 
requests structured according to an extensible messaging framework (e.g., SOAP) at 
202. In the SOAP example, content provider 202 sends a SOAP request to the web 
service (e.g., an alerts topic management web service as shown in FIG. 3). At 204, the 
web service receives a request from content provider 102. In this embodiment, the 
request specifies a selected notification management function, such as creation or 
deletion of a topic or enumeration of topics. The request is structured according to the 
messaging framework. At 206, request information is extracted from the request. The 
request information in the illustrated embodiment includes at least a content provider 
identifier CPID and a topic identifier TopiclD. Other request information may include a 
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topic name and a topic language. Alerts service 104 extracts the CPID from, for 
example, a header of the SOAP request. As part of the generalized messaging 
framework, embodiments of the invention create a response object in response to the 
received request. The response object is also structured according to the messaging 
framework and contains information regarding the success or failure of the request. 
Computer-executable instructions at 208 call for executing the selected notification 
management function (e.g., creation or deletion of a topic) based on the extracted 
request information. 

[0033] Referring now to FIG. 3, alerts service 104 hosts an implementation of 
protocols for notification-based applications as web services to which content providers 
102 may program using the protocols. In the illustrated embodiment, alerts service 104 
includes a topic management web service 302 and a subscription management web 
service 304. The topic management web service 302 implements a topic management 
protocol to allow the creation, updating, and enumeration of topics. Similarly, the 
subscription management web service 304 implements a subscription management 
protocol according to embodiments of the invention to allow content provider 102 to 
create, delete, or update subscriptions. Although described separately, the topic 
management service 302 and the subscription management service 304 may be 
implemented together. Another component of alerts service 104, namely, a notification 
web service 306, allows content providers 102 to submit notifications for delivery to 
subscribers. 

[0034] A web services component (e.g., an ASP.NET web service), for example, 
embodies subscription management web service 304. The subscription management 



I 



I 

EL 998652140 US 



1 3 MS#303476.01 (MSFT 5087) 



service 304 of FIG. 3 manipulates a user profile database (UPDB) or user profile store 
(UPS) 308 with, for example, a .NET dynamic-link library (DLL) assembly 310, to obtain 
information regarding the subscribing user based on the notification information 
received from content provider 102. The web service 304 further accesses the UPDB 
or UPS 308, a BLDB 312, a profile service 314, an instant messaging service 316, and 
the notification web service 306. As an example, MSN® Messenger or .NEP"^ 
Messenger provides a suitable instant messaging service 316 for use in connection with 
the invention. Also, a multi-site user authentication system, such as Microsoft® .NET™ 
Passport single sign-in service, is suitable for the profile service 314. 
[0035] According to embodiments of the invention, messaging service 316 is one 
of the endpoints to which alerts service 104 can deliver notifications. When a user signs 
up to receive notifications through alerts service 104, the user specifies whether he or 
she wants to receive notifications through messaging service 316. When the user signs 
up to receive notifications with respect to some content change (e.g., stock/news), he or 
she specifies information about how the notifications are to be routed. In this instance, 
the routing information is captured in UPS 308 as well. When notification web service 
304 receives a notification that needs to be delivered, it looks up the routing information 
in UPS 308 and delivers it the appropriate endpoints. Messaging service 316 is one 
exemplary endpoint. 

[0036] In one embodiment of the invention, subscription information in alerts 
service 104 is stored in the user profile sen/ice and in a broadcast list database (e.g., 
UPDB/UPS 308 and BLDB 312, respectively). When an affiliated content provider 102 
sends a subscription management request to subscription management web service 



EL 998652140 US 



14 MS#303476.01 (MSFT 5087) 



304, the web service implementation queries/updates the information in UPDB/UPS 308 
and BLDB312. 

[0037] Advantageously, the web service implemented by alerts service 104 takes 
the load off of subscription mirroring because the SOAP variant is less user interface 
intensive. Based on this service profile, one embodiment of the invention calls for a 
deployment scenario of running the web service on the web front ends. A throttling 
mechanism may be implemented in the web service to assert that the web service does 
not bog down the user interface. 

[0038] APPENDIX A describes an exemplary SOAP-based notification format 
according to embodiments of the invention. In the example of APPENDIX A, the 
notification format is encased in a SOAP envelope. 

[0039] FIGS. 4A-4C illustrate operations of subscription management web 
service 304 in an exemplary flow diagram. The subscription management web service 
304 allows content provider 102 to manage its own set of subscriptions and allows 
alerts service 104 to manage an end user's subscriptions. Key functions include: 
Subscribe an end user to a topic (a topic is a broadcast list or dynamic assignment); 
Unsubscribe an end-user from a topic; Update a set of subscriptions; Enumerate 
subscriptions; Create a topic; Update a topic; and Enumerate topics. 
[0040] In general, FIG. 4A illustrates an exemplary sign-in process for content 
provider 102. Following sign-in, the invention in this embodiment executes a web 
service boundary for subscription management. Depending on the outcome of the 
boundary function, alerts service 104 collects consent, routing, and confirmation 
information. FIG. 4B is an exemplary flow diagram illustrating aspects of the 
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subscription management web service boundary. In general, alerts service 104 
implements the web service responsive to requests structured according to an 
extensible messaging framework such as SOAP. Alerts service 104 queries a user 
profile store (e.g., UPS 308) for profile information corresponding to a user identifier 
(e.g., PUID) extracted from the request. Based on profile infonnatlon returned by the 
query, alerts service 104 further determines routing information for the notification. In 
turn, the invention in this example performs a selected management function such as 
creating a subscription for each TopicID in the request message. FIG. 4C provides 
additional detail regarding smart routing to determine the routing information for the 
notification. Additional aspects of FIGS. 4A to 4C will be described with reference to 
FIGS. 5A to 5E. 

[0041] FIG. 5A is an exemplary flow diagram of a selected management function 
of creating a subscription (i.e., Subscribe). The flow diagram shows a sequence of 
major function calls between the objects for creating a subscription. 1 ) Content provider 
102 posts a Subscribe Request; 2) the CPID context is retrieved, given the CPID field in 
the protocol matched with the username from the digest authentication; and 3) a 
Subscriber object is created (inherits from NPD_User). Continuing at 4) the PUID is 
used to make sure the profile data exists in UPDB/UPS 308 by a) trying to get the 
subscriber from the UPDB/UPS 308, b) checking if the subscriber was not found, c) if he 
or she was not found, getting the profile from a multi-site authencation system (e.g., 
profile service 314, and d) setting the members in the NPD_User, setting up routing 
(see table below), and filling in the profile in UPDB/UPS 308. Proceeding to 5) 
depending on the topic, either a new subscription or a new subscription in a broadcast 
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list is created, noting the timestamp for each subscription; 6) depending on outconie, 
some result is added to the SubscribeResponse; and 7) the Subscriber object is used to 
make an asynchronous call to messaging service 316 to hopefully get some additional 
data for a smarter routing for the created subscriptions. This may not complete until the 
SOAP session is done. The UPS timestamp is checked to verify that the user has not 
manually changed the routing settings. Steps 5-6 are repeated for each topic in the 
request, after which the response is returned. If, at 4c), it turns out the user does not 
have a profile at profile service 314, a Redirect element is added to the 
SubscribeResponse. When the I/O Completion call, at 6a), has ended and returns with 
a callback, the following occurs: I) (Callback); II) The member data is updated in 
UPDB/UPS 308; and III) an opt-out message may be sent. 

[0042] With respect to smart routing (see FIG. 4C), the following table show the 
various routing cases: 



# 


UPDB/UPS 


Profile 


Messaging 


Action 




User exists 


E-mail 


service 








shared 






1 


Yes 


n/a 


n/a 


Use existing routing 


2 


No 


Yes 


No Mgr 


{EmI.Log.} [10] 


3 


No 


Yes 


Mgr 


if (Mgr) {Mgr.Log,}; {EmI.Log,} 










[40] 


4 


No 


No 


No Mgr 


{ Log, }; [2] 


5 


No 


No 


Mgr 


if (Mgr) {Mgr.Log.}; {Log.} [33] 



[0043] The synchronous logic is: 
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If the user exists in UPDB/UPS 

Use the best routing according to #2-#5 using UPDB/UPS data 
Send an opt-out notification 

Else 

If the user has a profile 

If an email address is shared from the profile 
Set routing to { Eml, Log, } 

Note the need to check with messaging service 
Else 

Set routing to { Log, } 

Add the Redirect part to the response 
Note the need to check with messaging service 

Else 

Erroneous PUID ! 

[0044] If checking for presence via messaging service 316, an async request is 
performed to deliver a notification to messaging service 316 and look at the return code. 
The notification will either be an empty message or the opt-out notification. Once the 
request has been handled, a callback to the web service will be received. The logic of 
that callback is: 

If the user uses messaging service 

If we have the email address in the database 

Update the routing to if (Mgr) { Mgr, Log, }; { Eml, 

Log, } 

Else 

Update the routing to if (Mgr) { Mgr, Log, }; { Log, } 

Else 

// The routing is already set as good as is possible 

[0045] FIG. 5B is an exemplary flow diagram of a selected management function 
of deleting a subscription (i.e., Unsubscribe). 1 ) Content provider 102 posts an 
Unsubscribe Request; 2) the CPID context is retrieved, given the username from the 
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Digest authentication; 3) a Subscriber object is created; 4) the actual data is retrieved 
from the PUID, giving the ID and Bucket; 5) the subscription is deleted; 6) depending on 
outcome, some result is added to the SubscribeResponse; and 7) a notification is sent 
to the user, telling him or her of the action. Steps 5-6 are repeated for each topic in the 
request, after which the response is returned. 

[0046] FIG. 5C is an exemplary flow diagram of a selected management function 
of updating a subscription (i.e., Update Subscriptions). 1) Content provider 102 posts 
an Update Subscriptions Request; 2) the CPID context is retrieved; 3) a Subscriber 
object is created (this provides a translation between { PUID, Topicid } and 
Subscriptionid); 4) the Subscriber is populated from UPDB 308; 5) the new subscription 
is created; 6) the old subscription is deleted, if step 5 succeeded; and 7) a response 
part is added to the response. Steps 3-6 are repeated for each specified subscriber. 
[0047] FIG. 5D is an exemplary flow diagram of a selected management function 
of creating a topic (i.e., CreateTopic). As described above, a topic is a named set of 
notifications concerning a certain interest among the subscribers. A topic is specified as 
a uniform resource locator (URL) relative to the content provider's domain, and is on the 
form /bl/hexadecimaljdentifier, where hexadecimal Jdentifier \s a numeric value 
specified in hexadecimal. A subscriber can also subscribe to content provider 102, 
while being agnostic about topics. In that case, the topic Is specified as /. In one 
embodiment, the non-empty topic is a representation of a broadcast list, and an empty 
topic is a representation for the set of standard non-broadcast list notifications. 1 ) 
Content provider 102 posts an Create Topic Request; 2) the CPID context is retrieved; 
3) the list is created; and 4) a response is created. 
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[0048] FIG. 5E is an exemplary flow diagram of a selected management function 
of updating a topic (i.e., UpdateTopic). 1) Content provider 102 posts an Update Topic 
Request; 2) the CPID context is retrieved; 3) the list is updated; and 4) a response is 
created. 

[0049] In one embodiment of the invention, alerts service 104 provides 
performance monitoring with one or more of the following counters: 

Subscribe Requests In Total 

Subscribe Requests Per Second 

Average Processing Time For Subscribe Request 

Average Synchronous + Asynchronous Time For Subscribe Request 

Unsubscribe Requests In Total 

Unsubscribe Requests Per Second 

Average Processing Time For Unsubscribe Request 

CreateTopic Requests In Total 

CreateTopic Requests Per Second 

Average Processing Time For CreateTopic Request 

UpdateTopic Requests In Total 

UpdateTopic Requests Per Second 

Average Processing Time For UpdateTopic Request 
[0050] The alerts topic management service 302 allows content providers 102 to 
create and update topics via SOAP message requests. Key functions include creating, 
updating, and enumerating topics. The service 302 may be a fully functional web 
service. In one embodiment, alerts service 104 provides a command line utility 
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TopicControl to content providers 102. The command line utility permits web service 
requests to be made under the covers. 

[0051] As described above, alerts topic management service 302 may be an 
ASP.NET web service, and manipulates the BLDB 312 using the assembly 310. 
Service 302 may be deployed with the alerts subscription management service 304 on 
the web front ends. 

[0052] Once a request has been received, the web sen/ice 302 retrieves the 
CPID from the HTTP headers (placed by an authentication filter DLL, for example). The 
topic ID will be extracted from the SOAP message. Each request is handled differently 
depending on the type of request. During the processing of the request, an object 
derived from Response is built This is then sent back to content provider 102 as the 
response. The different requests are described below: 

[0053] CreateTopic: 1 ) Content provider 1 02 makes a CreateTopic request to the 
alerts topic management service 302; 2) alerts topic management service 302 extracts 
request information, namely, CPID from HTTP header; 3) service 302 creates a 
CreateTopicResponse object; and 4) for each <Topic> in <CreateTopic>; 4) alerts topic 
management service 302 extracts the topic information (e.g., topic ID, name, and 
language from SOAP nriessage); Set information (from 4a) in npdBroadcastList object, 
c) Create topic, and d) Call CreateTopicResponse.GetResponsePart() with the results; 
and 5) Return CreateTopicResponse back to content provider 102. 
[0054] UpdateTopic: 1) Content provider 102 makes an UpdateTopic request to 
the alerts topic management service 302; 2) alerts topic management service 302 
extracts request information, a) CPID from HTTP header; and 3) creates an 
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UpdateTopicResponse object. 4) For each <To> in <Target>, service 302 extracts the 
topic information, including Topic ID, from the SOAP message, and calls 
UpdateTopicResponse.GetResponsePartO with the results; and 5) returns 
UpdateTopicResponse back to content provider 102. 
[0055] In one embodiment of the invention, alerts service 104 provides 
performance monitoring with one or more of the following counters: 

CreateTopic Requests In Total 

CreateTopic Requests Per Second 

Successful CreateTopic Requests In Total 

Successful CreateTopic Requests Per Second 

Failed CreateTopic Requests In Total 

Failed CreateTopic Requests Per Second 

UpdateTopic Requests In Total 

UpdateTopic Requests Per Second 

Successful UpdateTopic Requests In Total 

Successful UpdateTopic Requests Per Second 

Failed UpdateTopic Requests In Total 

Failed UpdateTopic Requests Per Second 

EnumerateTopic Requests In Total 

EnumerateTopic Requests Per Second 

Successful EnumerateTopic Requests In Total 

Successful EnumerateTopic Requests Per Second 

Failed EnumerateTopic Requests In Total 
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Failed EnumerateTopic Requests Per Second 
[0056] FIG. 6 shows one example of a general purpose computing device in the 
form of a computer 70. In one embodiment of the invention, a computer such as the 
computer 70 is suitable for use in alerts service 104. 

[0057] In the illustrated embodiments, computer 70 has one or more processors 
or processing units 72 and a system memory 74. In the illustrated embodiment, a 
system bus 76 couples various system components including the system memory 74 to 
the processors 72. The bus 76 represents one or more of any of several types of bus 
structures, including a memory bus or memory controller, a peripheral bus, an 
accelerated graphics port, and a processor or local bus using any of a variety of bus 
architectures. By way of example, and not limitation, such architectures include Industry 
Standard Architecture (ISA) bus, Micro Channel Architecture (MCA) bus. Enhanced ISA 
(EISA) bus, Video Electronics Standards Association (VESA) local bus, and Peripheral 
Component Interconnect (PCI) bus also known as Mezzanine bus. 
[0058] The computer 70 typically has at least some form of computer readable 
media. Computer readable media, which include both volatile and nonvolatile media, 
removable and non-removable media, may be any available medium that may be 
accessed by computer 70. By way of example and not limitation, computer readable 
media comprise computer storage media and communication media. Computer storage 
media include volatile and nonvolatile, removable and non-removable media 
implemented in any method or technology for storage of information such as computer 
readable instructions, data structures, program modules or other data. For example, 
computer storage media include RAM, ROM, EEPROM, flash memory or other memory 
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technology, CD-ROM, digital versatile disks (DVD) or other optical disk storage, 
magnetic cassettes, magnetic tape, magnetic disk storage or other magnetic storage 
devices, or any other medium that may be used to store the desired information and 
that may be accessed by computer 70. Communication media typically embody 
computer readable instructions, data structures, program modules, or other data in a 
modulated data signal such as a carrier wave or other transport mechanism and include 

« 

any information delivery media. Those skilled in the art are familiar with the modulated 
data signal, which has one or more of its characteristics set or changed in such a 
manner as to encode information in the signal. Wired media, such as a wired network 
or direct-wired connection, and wireless media, such as acoustic, RF, infrared, and 
other wireless media, are examples of communication media. Combinations of the any 
of the above are also included within the scope of computer readable media. 
[0059] The system memory 74 includes computer storage media in the form of 
removable and/or non-removable, volatile and/or nonvolatile memory. In the illustrated 
embodiment, system memory 74 includes read only memory (ROM) 78 and random 
access memory (RAM) 80. A basic input/output system 82 (BIOS), containing the basic 
routines that help to transfer information between elements within computer 70, such as 
during start-up, is typically stored in ROM 78. The RAM 80 typically contains data 
and/or program modules that are immediately accessible to and/or presently being 
operated on by processing unit 72. By way of example, and not limitation, FIG. 6 
illustrates operating system 84, application programs 86, other program modules 88, 
and program data 90. 
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[0060] The computer 70 may also include other removable/non-removable, 
volatile/nonvolatile computer storage media. For example, FIG. 6 illustrates a hard disk 
drive 94 that reads from or writes to non-removable, nonvolatile magnetic media. FIG. 6 
also shows a magnetic disk drive 96 that reads from or writes to a removable, 
nonvolatile magnetic disk 98, and an optical disk drive 100 that reads from or writes to a 
removable, nonvolatile optical disk 102 such as a CD-ROM or other optical media. 
Other removable/non-removable, volatile/nonvolatile computer storage media that may 
be used in the exemplary operating environment include, but are not limited to, 
magnetic tape cassettes, flash memory cards, digital versatile disks, digital video tape, 
solid state RAM, solid state ROM, and the like. The hard disk drive 84, and magnetic 
disk drive 96 and optical disk drive 100 are typically connected to the system bus 76 by 
a non-volatile memory interface, such as interface 106. 

[0061] The drives or other mass storage devices and their associated computer 
storage media discussed above and illustrated in FIG. 6, provide storage of computer 
readable instructions, data structures, program modules and other data for the 
computer 70. In FIG. 6, for example, hard disk drive 94 is illustrated as storing 
operating system 110, application programs 112, other program modules 1 14, and 
program data 116. Note that these components can either be the same as or different 
from operating system 84, application programs 86, other program modules 88, and 
program data 90. Operating system 1 10, application programs 1 12, other program 
modules 1 14, and program data 1 16 are given different numbers here to illustrate that, 
at a minimum, they are different copies. 
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[0062] A user may enter commands and information into computer 70 through 
input devices or user interface selection devices such as a keyboard 120 and a pointing 
device 122 (e.g., a mouse, trackball, pen, or touch pad). Other input devices (not 
shown) may include a microphone, joystick, game pad. satellite dish, scanner, or the 
like. These and other input devices are connected to processing unit 72 through a user 
input interface 124 that is coupled to system bus 76. but may be connected by other 
interface and bus structures, such as a parallel port, game port, or a universal serial bus 
(USB). A monitor 128 or other type of display device is also connected to system bus 76 
via an interface, such as a video interface 130. In addition to the monitor 128, 
computers often include other peripheral output devices (not shown) such as a printer 
and speakers, which may be connected through an output peripheral interface (not 
shown). 

[0063] The computer 70 may operate in a networked environment using logical 
connections to one or more remote computers, such as a remote computer 134. The 
remote computer 134 may be a personal computer, a server, a router, a network PC, a 
peer device or other common network node, and typically includes many or all of the 
elements described above relative to computer 70. The logical connections depicted in 
FIG. 6 include a local area network (LAN) 136 and a wide area network (WAN) 138, but 
may also include other networks, LAN 136 and/or WAN 138 may be a wired network, a 
wireless network, a combination thereof, and so on. Such networking environments are 
commonplace in offices, enterprise-wide computer networks, intranets, and global 
computer networks (e.g., the Internet). 
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[0064] When used in a local area networking environment, computer 70 is 
connected to the LAN 136 through a network interface or adapter 140. When used in a 
wide area networking environment, computer 70 typically includes a modem 142 or 
other means for establishing communications over the WAN 138, such as the Internet 
The modem 142, which may be internal or external, is connected to system bus 76 via 
the user input interface 134, or other appropriate mechanism. In a networked 
environment, program modules depicted relative to computer 70, or portions thereof, 
may be stored in a remote memory storage device (not shown). By way of example, and 
not limitation, FIG. 6 illustrates remote application programs 144 as residing on the 
memory device. The network connections shown are exemplary and other means of 
establishing a communications link between the computers may be used. 
[0065] Generally, the data processors of computer 70 are programmed by means 
of instructions stored at different times in the various computer-readable storage media 
of the computer. Programs and operating systems are typically distributed, for example, 
on floppy disks or CD-ROMs. From there, they are installed or loaded into the 
secondary memory of a computer. At execution, they are loaded at least partially into 
the computer's primary electronic memory. The invention described herein includes 
these and other various types of computer-readable storage media when such media 
contain instructions or programs for implementing the steps described herein in 
conjunction with a microprocessor or other data processor. The invention also includes 
the computer itself when programmed according to the methods and techniques 
described herein. 
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[0066] For purposes of illustration, programs and other executable program 
components, such as the operating system, are illustrated herein as discrete blocks. It 
is recognized, however, that such programs and components reside at various times in 
different storage components of the computer, and are executed by the data 
processor(s) of the computer. 

[0067] Although described in connection with an exemplary computing system 
environment, including computer 70, the invention is operational with numerous other 
general purpose or special purpose computing system environments or configurations. 
The computing system environment is not intended to suggest any limitation as to the 
scope of use or functionality of the invention. Moreover, the computing system 
environment should not be interpreted as having any dependency or requirement 
relating to any one or combination of components illustrated in the exemplary operating 
environment. Examples of well known computing systems, environments, and/or 
configurations that may be suitable for use with the invention include, but are not limited 
to, personal computers, server computers, hand-held or laptop devices, multiprocessor 
systems, microprocessor-based systems, set top boxes, programmable consumer 
electronics, mobile telephones, network PCs, minicomputers, mainframe computers, 
distributed computing environments that include any of the above systems or devices, 
and the like. 

[0068] Embodiments of the invention may be described in the general context of 
computer-executable instructions, such as program modules, executed by one or more 
computers or other devices. Generally, program modules include, but are not limited to, 
routines, programs, objects, components, and data structures that perform particular 
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tasks or implement particular abstract data types. The invention may also be practiced 
in distributed computing environments where tasks are performed by remote processing 
devices that are linked through a communications network. In a distributed computing 
environment, program modules may be located in both local and remote computer 
storage media including memory storage devices. 

[0069] An interface in the context of software architecture includes a software 
module, component, code portion, or other sequence of computer-executable 
instructions. The interface includes, for example, a first module accessing a second 
module to perform computing tasks on behalf of the first module. The first and second 
modules include, in one example, application programming interfaces (APIs) such as 
provided by operating systems, component object model (COM) interfaces (e.g., for 
peer-to-peer application communication), and extensible markup language metadata 
interchange format (XMI) interfaces (e.g., for communication between web services). 
[0070] The interface may be a tightly coupled, synchronous implementation such 
as in Java 2 Platform Enterprise Edition (J2EE), COM, or distributed COM (DOOM) 
examples. Alternatively or in addition, the interface may be a loosely coupled, 
asynchronous implementation such as in a web service (e.g., using the simple object 
access protocol). In general, the interface includes any combination of the following 
characteristics: tightly coupled, loosely coupled, synchronous, and asynchronous. 
Further, the interface may conform to a standard protocol, a proprietary protocol, or any 
combination of standard and proprietary protocols. 

[0071] The interfaces described herein may all be part of a single interface or 
may be implemented as separate interfaces or any combination therein. The interfaces 



EL 998652140 US 29 MS#303476.01 (MSFT 5087) 

may execute locally or remotely to provide functionality. Further, the interfaces may 
include additional or less functionality than illustrated or described herein. 
[0072] In operation, computer 70 executes computer-executable instructions 
such as those described herein for implementing a web service responsive to requests 
structured according to an extensible messaging framework (e.g., SOAP). The web 
service implemented by computer 70 receives a request from content provider 102 that 
specifies a selected notification management function. In this instance, the request is 
structured according to the messaging framework. Computer 70 further executes 
computer-executable instructions to extract request information, including at least a 
content provider identifier and a topic identifier, from the request and to execute the 
selected notification management function based on the extracted request information. 
[0073] The order of execution or performance of the methods illustrated and 
described herein is not essential, unless otherwise specified. That is, elements of the 
methods may be performed in any order, unless othenA/ise specified, and that the 
methods may include more or less elements than those disclosed herein. 
[0074] Information in this document, including uniform resource locator and other 
Internet web site references, is subject to change without notice. Unless othen/vise 
noted, the example companies, organizations, products, domain names, e-mail 
addresses, logos, people, places and events depicted herein are fictitious, and no 
association with any real company, organization, product, domain name, e-mail 
address, logo, person, place or event is intended or should be inferred. 
[0075] When introducing elements of the present invention or the embodiment(s) 
thereof, the articles "a," "an," "the," and "said" are intended to mean that there are one 
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or more of the elements. The terms "comprising," "including," and "having" are intended 
to be inclusive and mean that there may be additional elements other than the listed 
elements. 

[0076] In view of the above, it will be seen that the several objects of the 
invention are achieved and other advantageous results attained. 
[0077] As various changes could be made in the above constructions, products, 
and methods without departing from the scope of the invention, it is intended that all 
matter contained in the above description and shown in the accompanying drawings 
shall be interpreted as illustrative and not in a limiting sense. 
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APPENDIX A 

[0078] This appendix describes an exemplary SOAP-based notification format 
according to embodiments of the invention. In this example, the notification format is 
now encased in a SOAP envelope, rather than a proprietary container; and it uses 
routing headers from WS-Routing. 
[0079] Sample Request 

<?xml version="l. 0" encoding="utf -8" ?> 

<S : Envelope xmlns :S= "http : //schemas .xmlsoap .org /soap /envelope/ " 
xmlns :A= "http : //alerts .microsoft . com/ws/2002/l2/notif ication" 

xmlns : wsu="http : //schemas .xmlsoap . org/ws/2002/07/utility" > 

<S :Header> 

<wsu : Expires >2 002- 10 -12T0 9 : 00 : OOZ</wsu : Expires > 

<R:path S :mustUnderstand="true" xmlns :R=s"http : // schemas .xmlsoap . org/rp/ " > 
<R: action>http : //alerts . microsoft . com/ws/nrouter/notif y</R : action> 
<R: fwd> 

<R : via>http : / /alerts .microsoft . com/ws/nrouter</R : via> 
</R: f wd> 
<R:rev> 

<R : via 

vid="cpid : 102 ;nid : 30 ">http : / /www. contentprovider . com/ someuri</R : via> 
</R : rev> 
</R :path> 

<A: Target S :mustUnderstand="true" > 
<A:ToPPUser pName="personA®microsof t . com" puid="0x00001111 : 0x22223333" 

/> 

</A: Targe t> 

<A: From S : must Understands "true" pName="personB®microsof t . com" 
puid="0x44445555 : 0x66667777" /> 
</S :Header> 
<S :Body> 

<A:Notify xml ; lang= "en-us " > 
<A : Meta baseUrl= "ht tp : / /www . contentprovider . com" > 
<A: Action url= " /action . aspx" /> 
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<A:Subscr url="/subscr .aspx" /> 

<A:Icon url="/icon. jpg" /> 

<A: Subject >Today ' s Alert</A: Subject> 
</A:Meta> 
<A: Content > 

<A:View contentType="text/plain">Hello, here is your .NET Alert of the 
day . </A: View> 

<A:View contentType="text/plain" deviceHint= "mobile " >Here is your .NET 
Alert</A: View> 

<A:View contentType=" text /plain" act ion=" /act ion. aspx" >Click here for 
you .NET Alert of the day ! </A: View> 

<A : View cont entType= " text /html " deviceHint= " emai 1 " sub j ect = " Today ' s 
Alert"><html> 6clt ;bodyScgt ; &lt / hl&gt ; Hello&lt / /hl&gt ; &lt ; h2&gt ; Here is 
your .NET Alert < /h2&gt ; &lt ; /body> &lt ; /html&gt ; </A: View> 
< /A: Content > 
</A:Notify> 
</S:Body> 
</S : Envelope> 



[0080] 



Details 



Header/Expires 



Header/path/action 



Header/path/fwd/via 
Header/path/rev/via 
Header/path/rev/via/@vid 



OPTIONAL. Date/time that conforms to XML 
Schema datatype dateTime. 

MUST be 

http://alerts.microsoft.com/ws/nrouter/notify 

MUST be http://alerts.microsoft.com/ws/nrouter 

The content provider URI 

MUST be of the format cpid:xxxxx;nid:yyyyy, 
where xxxxx denotes the content provider ID 
and yyyyy denotes the notification ID. 



Header/Target/ToPPUser/@pName Passport name (email). 



Header/Target/ToPPUser/@puid Passport ID. 
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Header/Target/ToTopic/@topicld 


Broadcast list ID. MUST be of the form 




/bl/Ox<hexidentifier> or /bl/<decidentiTier> 


Header/From/@pName 


Passport name (email) of the source (i.e. the 




content provider sends a notification on behalf 




\J\ 11 HO |JC7I Owl ly. 


H ead er/F rom/@ pu id 


Passport ID of the source. 


The Target element may contain multiple ToPPuser elements (up to 100). If sending 


to a topic, only one ToTopic may be present. 


Body/Notify/@xml:lang 


Xml language token 


Bodv/Notifv/Meta/®baseUrl 


Base URL for content orovider's action, subscr 




and icon URL's. MUST NOT end with a 7'. 


Body/Notify/Meta/Action/@url 


Action URL, to retrieve additional information 




about the alert. 


Body/Notify/Meta/Subscr/@url 


Subscription URL, where a user can manage the 




subscription corresponding to the alert. 


Body/Notify/Meta/Subject 


The subject of the notification, used by some 




endpoints 


Body/Notif y/Meta/l con/@ u rl 


Icon URL, to display icon in the alert body. 


Body/ContentA/iew 


The instances of the notification. Different 




instances can be specified to take advantage of 




specific formatting or other a priori knowledge of 




endpoint capabilities. If the contentType is either 


r 


"text/html" or "text/xml", the actual content must 




be xml-encoded. 




Several views may exist, but there must always 




be one view with no deviceHint and 
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contentType="text/plain". 
Body/ContentA/iew/@contentType One of "text/plain", "text/html" or "text/xml" 
Body/ContentA/iew/@deviceHint A semi-colon separated list of the devices this 

particular view is intended for. The list may 
contain one or more of "email", "log", 



Body/ContentA/iew/@action 



Body/ContentA/iew/@subject 



"messenger", or "mobile". 
Relative URL (from @baseUrl) where extended 
content may be retrieved. This overrides 
Body/Notify/Meta/Action/@url for this view. 

The subject for this notification, overriding 
Body/Notify/Meta/Subject for this view. 



[0081] Sample Success Response 

[0082] For successful packets, the invention may return the following SOAP 
message. 

<?xml version="l . 0" encoding="utf -8" ?> 

<S : Envelope xmlns : S= "http : / / schemas . xmlsoap . org/soap/envelope/ " 
xmlns : A= "http : //alerts .microsoft . com/ws/2002/12/notif ication" 

xmlns :R=" http : //schemas .xmlsoap .org/ rp/"> 

<S :Header> 
<R:path> 

<R : action>http : //alerts . microsoft . com/ws/nrouter/ notif yResponse</R : action> 
<R : f wd> 
<R:via 

vid="cpid: 102 ;nid: 30">http : //www. contentprovider . com/someuri</R: via> 
</R: fwd> 
<R : rev> 

<R : via>http : //alerts . microsoft . com/ws/nrouter</R : via> 
</R : rev> 
</R:path> 
</S :Header> 
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<S :Body> 




<A : Not i f yResponse / > 




</S :Body> 




</S :Envelope> 




[0083] Success Response Details 


Header/path/fwd/via 


The content provider URI 


Header/path/fwd/via/@vid 


Format cpid:xxxxx;nid:yyyyy, where xxxxx denotes 




the content provider ID and yyyyy denotes the 




notification ID. 


Header/path/rev/via 


Always http://alerts.microsoft.com/ws/nrouter 


Header/path/action 


http://alerts.microsoft.com/ws/nrouter/notifyResponse 


Body/NotifyResponse 


Empty element 



[0084] Sample Failure Response 

[0085] For failures, the invention may send back a SOAP message containing a 
SOAP 1.1 fault. 

<?xml version="l . 0" encoding-" utf -8" ?> 

<S : Envelope xmlns : S="http : //schemas .xml soap .org/ soap/ envelope/ 
xmlns :A= "http : //alerts . microsoft . com/ws /2 002/ 12 /notification" > 
<S :Body> 
<S : Fault> 
<f aultcode>S : Client</f aultcode> 

<f aultstring>A client error occurred while processing request to 
Microsoft .NET Alerts service. </faultstring> 

<f aultactor>http : //alerts .microsoft . com/ws/nrouter</ f aultactor> 
. <detail> 

<A: Alert sWSFault> 

<A: Code>A:Notif ication.Malf ormedPack:et</A: Code> 
<A:Message>iyialf ormed packet at Envelope/Body/Not i fy/Content2 . 
Expected fequot; Content iquot ; . </A:Message> 

<A:Detail /> 
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</A:AlertsWSFault> 




</detail> 




</S:Fault> 




</S :Body> 




< / S : Enve lope > 


• 


LUUooj raiiure K6spons6 ueiaiis 




Body/Fault/faultcode 


SOAP 1.1 qualified fault code ^ 


Body/Fault/faultstring 


Generic message describing the fault 


Body/Fault/faultactor 


Where the fault occurred. 


Body/Fault/detail 


Extensibility element 


Body/Fault/detail/AlertsWSFault/Code 


Alerts qualified fault code 


Body/Fault/detail/AlertsWSFault/Message 


Message describing the fault 


Body/Fault/detail/AlertsWSFault/Detail 


Extensibility element 



^ The SOAP 1.1 specification defines only a few enumerated values that are allowed: 

• Client - The incoming message was malformed in some way 

• Server - Server encountered some error processing the message 

• MustUnderstand - Our service did not know how to process a header element 
with a mustUnderstand="true" 

• VersionMismatch - The message sent was using a different SOAP version that 
what we expected 

^These are the fault codes that we will return: 



[0087] Server Error 
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<f aultcode>S : Server</f aultcode> 

<A : Code >A : Not i f icat ion . ServerEr ror < /A : Code > 

[0088] Malformed Packet 

<f aultcode>S :Client</f aultcode> 

<A : Code>A : Notification . Malf ormedPacket </A : Code> 

[0089] Send Limit Exceeded 

<f aultcode>S :Client</ f aultcode> 

<A: Code>A: Notification. SendLimitExceeded</A: Code> 

[0090] Unknown Header Error 

<faultcode>S :MustUnderstand</f aultcode> 

< A : Code >A : Not i f i cat ion . UnknownHeader < / A : Code > 

[0091] Sample Packets 
[0092] Messenger I nvite 

<?xml version="l . 0" encoding="utf -8 " ?> 

<S : Envelope xmlns : S="http : //schemas .xmlsoap . org/ soap/envelope/ " 
xmlns :A= "http : //alerts .microsoft . com/ws/2002/12/notif ication" > 
<S :Header> 

<R : path S : mus tUnderstand= " true " xmlns : R= "http : / /schemas . xmlsoap . org/rp/ " > 
<R : act ion>http : //alerts . microsoft . com/ws/nrouter/invite</R : action> 
<R:fwd> 

<R:via>http : //alerts .microsoft . com/ws/nrouter</R:via> 
</R: fwd> 
<R : rev> 

<R:via vid="cpid: 103 ;nid: 100">http : //messenger . microsoft . com</R:via> 
</R : rev> 
</R:path> 

<A : Target S : mus tUnderst and= " true " > 



I 

EL 998652140 US 



38 



MS#303476.01 (MSFT 5087) 



<A:ToPPUser pName="personC®microsof t .com" puid="0x44443333 : 0x22221111" 

/> 

<A:ToPPUser pName= "personDOmicrosof t . com" puid=" 0x33334444 : 0x11112222" 

/> 

</A:Target> 

<A: From S :mustUnderstand=" true" pName="personE®microsof t . com" 
puid="0x22221111: 0x00008888" /> 
</S : Header > 
<S : Body> 

<!-- PROTOCOL -SPECIFIC BODY --> 
</S:Body> 
</ S : Envelope> 



[0093] Messenger Presence-Change 

<?xml version="l . 0" encoding="utf -8 " ?> 

<S : Envelope xmlns : S= "http : / / schemas , xmlsoap . org/ soap/ envelope/ " 
xmlns : A="http : //alerts .microsoft . com/ws/2002/12/notif ication" > 
<S :Header> 

<R : path S : mus tUnders tand= "true " xmlns : R= " ht tp : / / schemas . xmlsoap . org/rp/ " > 

<R: action>http : / /alerts .microsoft . com/ws/nrouter/presenceChange</R: action> 
<R: fwd> 

<R : via>http : //alerts . microsoft . com/ws/nrouter</R : via> 
</R:fwd> 
<R: rev> 

<R : via vid= " cpid : 103 ; nid : 101 " >http : / /messenger . microsoft . com</R : via> 
</R:rev> 
</R:path> 

<A : Target S : mus t Under stands^ " true " > 
<A:ToPPUser pName= "personCOmicrosof t . com" puid=" 0x44443333 ; 0x22221111" 

/> 

</A:Target> 

<A : From S : mus t Understands " true " pName= "personE®microsof t . com" 
puid="0x22221111: 0x0000 8888" /> 
</S :Header> 
<S :Body> 
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<!-- PROTOCOL-SPECIFIC BODY --> 
</S :Body> 
</S : Envelope> 

[0094] Mobile Non-2-Way-IM 

<?xml version=" 1 . 0 " encoding=:"utf -8 " ?> 

<S : Envelope xmlns : S="http : //schemas .xmlsoap . org/soap/ envelope/ " 
xmlns :A= "http : //alerts .microsoft . com/ws/2002/12/notif ication"> 
<S: Header > 

<R : path S : mustUnders tand= " true " xmlns : R= "http : // schemas . xmlsoap . org/rp/ " > 
<R: action>http : //alerts .microsoft . com/ws/nrouter/notif y</R : action> 
<R:fwd> 

<R:via>http : //alerts .microsoft . com/ws/nrouter</R: via> 
</R: f wd> 
<R: rev> 

<R: via vid="cpid: 104 ;nid: 100" >http : / /mobile . microsoft . com</R: via> 
</R:rev> 
</R:path> 

<A: Target S :mustUnderstand="true" > 
<A:ToPPUser pName="personC®microsoft . com" puid="0x44443333 : 0x22221111" 

/> 

< /A: Target > 
</S :Header> 
<S :Body> 

<A: Notify xml : lang="en" > 
<A:Meta baseurl="http : //mobile .microsoft . com"> 
<A:Action url="/action.aspx" /> 
<A:Subscr url="/subscr . aspx" /> 
<A:Icon url="/icon. jpg" /> 
</A:Meta> 
<A: Content > 

<A:View contentType=" text /plain" >Virgo : ??? . </A: View> 
</A:Content> 
</A:Notify> 
</S :Body> 
</S :Envelope> 
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[0095] 



Mobile 2-Way-IM 



<?xml version="l . 0" encoding="utf -8" ?> 

<S : Envelope xmlns : S="http : // schemas .xml soap . org/ soap/ envelope/ " 
xmlns : A= "http : //alerts .microsoft . com/ws/2002/l2/notif ication"> 
<S :Header> 

<R:path S :mustUnderstand=" true" xmlns : R="http : / /schemas .xmlsoap .org/ rp/"> 
<R : action>http : / /alerts . microsoft . com/ws/nrouter/ notif y</R : action> 
<R: f wd> 

<R: via>http : //alerts .microsoft . com/ws/nrouter</R: via> 
</R: fwd> 
<R : rev> 

<R: via vid="cpid : 104 ; nid: 100 ">http : //mobile . microsoft . com</R: via> 
</R:rev> 
</R :path> 

<A : Target S : mus tUnders tand= " true " > 
<A:ToPPUser pName="personC@microsof t . com" puid="0x44443333 :0x22221111" 



</A: Targe t> 

<A: From S : mus tUnderstand=" true" pName="personE@microsof t .com" 
puid=" 0x22221111: 0x00008888" /> 
</S :Header> 
<S:Body> 

<A: Notify xml : lang= "en" > 
<A:Meta baseurl= "http : //mobile .microsoft . com"> 
<A: Action url= " /action , aspx" /> 
<A:Subscr url="/subscr .aspx" /> 
<A:Icon url="/icon. jpg" /> 
</A:Meta> 
<A: Content > 

<A:View contentType= "text/plain" >Sample mobile content</A: View> 
</A:Content> 
</A:Notify> 
</S:Body> 
</S : Envelope > 



/> 
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[0096] 



Voice 



<?xml version="l . 0" encoding="utf -8 " ?> 

<S : Envelope xmlns : S= "http : //schemas .xmlsoap . org/ soap/ envelope/ " 
xmlns :A= "http : //alerts .microsoft . com/ws/2 002/12/notif ication" > 
<S : Header > 

<R:path S :mustUnderstand="true" xmlns :R=" http : //schemas .xmlsoap.org/rp/"> 
<R:action>http: //alerts .microsoft . com/ws/nrouter/notify</R:action> 
<R: fwd> 

<R:via>http : //alerts . microsoft . com/ ws/nrouter</R :via> 
</R: f wd> 
<R:rev> 

<R : via vid= "cpid : 105 ; nid : 100 " >http : //voice . microsoft . com</R : via> 
</R: rev> 
</R:path> 

<A: Target S :mustUnderstand="true"> 
<A:ToPPUser pName="personc@microsof t . com" puid="0x44443333 : 0x22221111" 



< /A: Target > 

<A : From S : mus t Under stand= "true " pName= "personE@microsof t . com" 
puid="0x22221111: 0x00008888" /> 
</S:Header> 
<S ;Body> 

<A: Notify xml ; lang="en" > 
<A : Meta baseurl= "http : //voice . microsoft . com" > 
<A: Action url="/action. aspx" /> 
<A:Subscr url="/subscr .aspx" /> 
<A:Icon url="/icon. jpg" /> 
</A:Meta> 
<A: Content > 

<A:View contentType="text/plain">Voice specific content</A: View> 
</A: Content> 
</A:Notify> 
</S :Body> 
</ S : Envelope > 



/> 



[0097] 



Schemas 



I 
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[0098] AlertsWS-Notify.xsd 

<?xml version="l . 0" encoding="utf -8" ?> 

<xs : schema xmlns : AN="http : //alerts . microsoft . com/ws/2 002/ 12 /notification" 
xmlns :xs="http : //www. w3 . org/200l/XMLSchema" 

targetNamespace="http : //alerts .microsoft . com/ws/2002/l2/notification" 
elementFormDefault= "qualified" > 

<xs : import namespace="http : / /www. w3 .org/XiyiL/1998/namespace" /> 
<xs : simpleType name="Puid__t " > 

<xs : restriction base="xs : string"> 

<xs:pattern value="0[xX] [0-9a-fA-F] {l, 8} :0 [xX] [0-9a-f A-F] {l, 8} " /> 
</xs : restriction> 
</xs : simpleType> 
<xs : s impleType name= " PName_t " > 

.<xs : restriction base="xs : string" > 

<xs : maxLength value="12 7" /> 
</xs : restriction> 
</xs : simpleType> 
<xs : simpleType name="Email_t"> 

<xs : restriction base="xs : string" > 

<xs : maxLength value="127" /> 
</xs : restriction> 
</xs : simpleType> 

<xs : simpleType name="TopicId_t"> 

<xs : restriction base="xs : string" > 
<xs:pattern value=" /bl/0 [xX] [0-9a-f A-F] {l, 8 } " /> 

</xs : restriction> 
</xs : simpleType> 

<xs : complexType name= "ToPPUser__t " > 
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<xs : attribute name="puid" type="AN:Puid_t use= "required" /> 
<xs :attribute name="pName" type="AN: PName^t " use= "optional" J> 
<xs : attribute name= "email" type="AN:Email_t " use= "optional" /> 

</xs : complexType> 

<xs : complexType name="ToTopic_t"> 

<xs : attribute name="topicId" type="AN:TopicId_t " use=" required" /> 

</xs : complexType > 

<xs : complexType name=s " Targe t_t " > 
<xs : choice> 

<xs:element name="ToPPUser" type="AN:ToPPUser_t" maxOccurs="100" /> 
<xs:element name="ToTopic" type="AN;ToTopic_t" /> 

</xs : choice> 

<xs : anyAttribute / > 
</xs : complexType> 
<xs: complexType name="From_t "> 

<xs : attribute name="puid" type="AN: Puid_t " use="optional " /> 

<xs lattribute name="pName" type="AN: PName_t " use= "optional" /> 

<xs : anyAttribute /> 
</xs : complexType > 
<xs : simpleType name= "Url_t " > 

<xs : restriction base= "xs : string" > 
<xs : maxLength value="255" /> 

</xs : restriction> 
</xs : simpleType> 

<xs : simpleType name="Subject_t "> 
<xs : restriction base="xs : string" > 

<xs : maxLength value="255" /> 
</xs : restriction> 
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</xs : simpleType> 

<xs :complexType name="MetaUrl_t"> 

<xs : attribute name="url" type="AN:Url_t" /> 
</xs : complexType> 
<xs : complexType name= "Meta_t " > 
<xs : sequence > 
<xs: element name = "Action" type="AN:MetaUrl_t" /> 
<xs:element name="Subscr" type="AN:MetaUrl_t" /> 
<xs: element name="Icon" type="AN:MetaUrl_t " /> 
<xs: element name=" Subject" type="AN: Subject_t " minOccurs="0 " 
maxOc cur s = " 1 " / > 

</xs : sequence> 

<xs lattribute name="baseUrl" type="xs :anyURI" use= "required" /> 
</xs ; complexType> 

<xs : simpleType name=: "ContentType_t " > 

<xs : restriction base="xs : string"> 
<xs : maxLength value="15" /> 

</xs : restriction> 
</xs : simpleType > 

<xs : simpleType name="DeviceHint_t "> 
<xs :restriction base="xs :string"> 

<xs : maxLength value="31" /> 
</xs : restriction> 
</xs:simpleType> 
<xs : complexType name= " View_t " > 
<xs : simpleContent> 
<xs : extension base= "xs : string" > 



I 
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<xs : attribute name= " contentType " type= "AN : ContentType_t " 
use= " required" / > 

<xs : attribute name="deviceHint " type="AN :DeviceHint_t " /> 
<xs rattribute name= "action" type="AN:Url_t" /> 
<xs : attribute name=" subject" type="AN:Subject_t " /> 
</xs : extension> 
</xs : simpleContent> 
</xs : complexType> 

<xs : complexType name= " Content_t " > 
<xs : sequence> 

<xs: element name="View" type="AN:View_t " minOccurs="l" maxOccurs="6" /> 
</xs : sequence> 
</xs : complexType > 
<xs : complexType name= "Notif y__t " > 
<xs : sequence> 
<xs: element name="Meta" type="AN:Meta_t " /> 
<xs: element name = "Content " type="AN:Content__t" /> 
</xs : sequence> 

<xs rattribute ref ="xml : lang" use=" required" /> 
</xs : complexType> 
<xs : simpleType name="Code_t"> 

<xs : restriction base="xs :QName" > 
<xs : enumeration value="AN:Notif ication.MalformedPacket" /> 
<xs : enumeration value= "AN : Notif icat ion . SendLimi tExceeded" / > 
<xs : enumeration value= "AN : Notification . ServerError " / > 
<xs : enumeration value="AN:Notif ication.UnknownHeader" /> 
<xs : enumeration value= "AN : Notification . Unauthori zedSite " / > 

</xs : restriction> 
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</xs : simpleType> 

<xs : complexType name= "Detail_t " > 
<xs : sequence> 

<xs:any namespace="##any" minOccurs="0" maxOccurs= "unbounded" 
processContents= " lax" / > 
</xs : sequence> 

<xs : anyAttribute namespace="##any" processContents="lax" /> 
</xs : complexType> 

<xs : complexType name= "Status Pi ece_t " > 
<xs : sequence> 
<xs: element name="Code" type="AN:Code_t" /> 

<xs: element name= "Reason" type="xs : string" minOccurs= "0 " /> 
<xs: element name= "Detail" type="AN:Detail_t" minOccurs="0" /> 
</xs : sequence> 
</xs : complexType> 

<xs : complexType name= "Notif yResponse_t " > 
<xs : sequence> 

<xs:any namespace="##any" minOccurs="0" maxOccurs= "unbounded" 
processContents="lax" /> 
</xs : sequence> 

<xs : anyAttribute namespace="##any" processContents="lax" /> 
</xs : complexType > 

<xs: element name= "Target" type="AN:Target_t" /> 
<xs: element name="From" type="AN: From_t" /> 
<xs: element name= "Notify" type="AN:Notify_t " /> 

<xs: element name="Notif yResponse" type="AN:NotifyResponse_t" /> 
<xs: element name=" Alert sWSFault" type="AN: StatusPiece__t " /> 
</xs : schema> 
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[0099] 



AlertsWS-Notify.wsdl 



<?xml version="l . 0" encoding="utf -8 " ?> 
<def initions 

xmlns :AN= "http : //alerts .microsoft . com/ ws/ 2 002/ 12 /notification" 
xmlns : r="http : // schemas .xml soap . org/ rp/ " 



xmlns : soap="http : //schemas .xml soap . org/wsdl/soap/ " 

targetNamespace="http : //alerts .microsoft . com/ws/2002/ 12 /notification" 

xmlns = "http : // schemas .xml soap . org/wsdl/ " 

xmlns :w= "http : //schemas .xmlsoap . org/wsdl/ "> 
<import namespace="http : / /alerts .microsoft . com/ws/2002/l2/notif ication" 
locations" schema/Alert sWS -Not if icat ion. xsd" /> 

< import namespace="http : // schemas .xmlsoap . org/ rp/" 
locations " schema/ SOAP -RP . xsd" / > 
<message name="NotifyIn" > 

<part name="Notify" element= "AN: Notify" /> 
</message> 

<message name= "Notif yResponseOut " > 

<part name =" Not ifyResponse" element="AN :NotifyResponse" /> 
</message> 

<message name="PathIn" > 

<part name="path" element="r :path" /> 
</message> 

<message name="PathOut"> 

<part name="path" element="r :path" /> 
</message> 

<message name= "Target In " > 



<part name= "Target" element= "AN: Target 



" /> 
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</message> 

<message name="FromIn"> 

<part name="From" element="AN:From" /> 
</message> 

<portType name= " Not ifyPort Type " > 
< operation name = "Notify" > 

<input message="AN:NotifyIn" /> 
<output message="AN:NotifyResponseOut " /> 
</operation> 
</portType> 

<binding name="NotifyBinding" type="AN:NotifyPortType"> 

< soap : binding transport="http : //schemas .xmlsoap . org/soap/http" 
s tyle=" document " /> 

<operation name="Notify"> 

<soap : operation 

soapAction="http : //alerts . microspft . com/ws/2 0 02 /12/not if icat ion/notify" 
style= "document " /> 

< input > 

<soap:body use=" literal" /> 
< soap: header w: required="true" 
message= " AN : Pathin" part = "path" use= "literal " / > 

<soap: header w: required="true" 
message= "AN : Target In" part = "Target " use= "literal " / > 

<soap : header w: required=" false" 
messages "AN :FromIn" part="From" use="literal" /> 

</ input > 
<output> 

<soap:body use=" literal" /> 
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<soap: header w:required="true" 
messages "AN: Pa thOut" part = "path" use=" literal" /> 

</ output > 

</operation> 
</binding> 

<service name="AlertsWS-Notif ication"> 

<port name="Notif yPort " binding="AN :NotifyBinding" > 

<soap: address 

locations "http : //alerts .microsoft . com/nrouter/AlertsWS-Notif ication. asmx" /> 

</port> 
</service> 

</def initions> 



